home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pmqwkb07.zip / PMQWK.DOC < prev    next >
Text File  |  1993-01-19  |  45KB  |  979 lines
  1.                                      Oberon PMQWK Offline Mailreader
  2.                                  ** BETA ** Version 1.00, Release #7
  3.                                                     19 January, 1993
  4.  
  5.                                                      Oberon Software
  6.                                                518 Blue Earth Street
  7.                                           Mankato, MN 56001-2142 USA
  8.  
  9.                                                  Voice: 507-388-7001
  10.                                                  Fax:   507-388-7568
  11.                                                  BBS:   507-388-1154
  12.  
  13.                                             Fidonet:        1:292/60
  14.                                            MCI Mail: oberon/413-5847
  15.                                                 CIS:      72510,3500
  16.                                               GEnie:       B.FLOWERS
  17.  
  18.  
  19.                         ** CAUTION ***
  20.  
  21. The accompanying software is a BETA TEST version.  It is NOT
  22. guaranteed to be complete or free from defects.  This software and
  23. documentation are subject to change and do not in anyway imply a
  24. commitment on the part of Oberon Software or the author.
  25.  
  26. If you use this software, you do so at your own risk.  Oberon
  27. Software will not be liable for any losses or damages to property,
  28. data, time, or business which arise as the direct or indirect result
  29. of the use, misuse, or failure to be able to use this software or
  30. documentation.  Your acceptance of these terms is implied by your use
  31. of this software and documentation.
  32.  
  33. Although this is a BETA TEST version, Oberon Software has released
  34. this version for wide distribution.  All of the above disclaimers
  35. apply and you are cautioned to not use this software if you do not
  36. agree to the disclaimers in this file.  Your use of this software
  37. will imply your acceptance.  You are free to distribute this package
  38. as you would any other shareware program under the provision that
  39. no changes are made in any way to the software or the accompanying
  40. documentation and that the entire package, complete with this
  41. documentation is distributed together as a unit.
  42.  
  43. If, while using this software, you should discover any program errors
  44. or omissions which are not otherwise mentioned in this document
  45. (please read "Features and Functions Absent in this BETA TEST
  46. Version" below before submitting a problem report), please contact
  47. Kimberly Bobrow at Oberon Software by one of the methods given below
  48. and alert us to the existence of the problem so that it may be
  49. corrected.  If the problem results in a system error popup (i.e., a
  50. TRAP 000D or other system trap) please make note of the values of
  51. "CS" and "IP" from the system error display.  Also, please indicate
  52. the version and release number of the software which experienced the
  53. problem.
  54.  
  55.   ┌────────────────────────────────────────────────────────────────┐
  56.   │ Contact for bug reports and enhancements requests:             │
  57.   │                                                                │
  58.   │   Oberon BBS or OS/2 Shareware BBS to Kimberly Bobrow          │
  59.   │   Fidonet to Kimberly Bobrow at either 1:141/261 or 1:292/60   │
  60.   │   Internet to Kimberly.Bobrow@hnews.fidonet.org                │
  61.   │   Voice phone: 212-465-3367                                    │
  62.   └────────────────────────────────────────────────────────────────┘
  63.  
  64.  
  65.                       **** CONTENTS ****
  66.  
  67.         Caution
  68.  
  69.         I. Overview
  70.  
  71.         II. Installation
  72.           A. Files
  73.           B. First time startup
  74.             1. Paths and Options
  75.             2. Your first QWK packets
  76.  
  77.         III. Using PMQWK
  78.           A. Unpacking QWK packets
  79.           B. Reading messages
  80.             1. The "List" function
  81.             2. The "Copy" function
  82.             3. The "Replies" conference
  83.           C. Replying to messages
  84.             1. The editor
  85.               a. Word Wrap
  86.             2. Messages which are not replies
  87.           D. Packaging replies for upload
  88.           E. The Address Book
  89.             1. Copying information to the Envelope window
  90.           F. Options
  91.             1. Fonts
  92.             2. Colors
  93.             3. Paths
  94.             4. Editor
  95.             5. Preferences
  96.               a. Beep on personal messages
  97.               b. Attribute quotes
  98.               c. Wrap Column for Quotes
  99.               d. Prepend "Re:" to response subject lines
  100.               e. Strip existing "Re:" from subject lines
  101.               f. Prev/Next buttons on right in message reader
  102.               g. Use Taglines
  103.               h. Use PMQWK Cutline
  104.               i. Show only active conferences
  105.             6. Save options
  106.             7. Icons
  107.  
  108.  
  109.                         **************
  110.  
  111. I.   Overview
  112.  
  113. PMQWK is a 32-bit, Presentation Manager (tm) based program for use
  114. with OS/2 version 2.0 or later.  Its purpose is to facilitate the
  115. reading and reply process for messages downloaded from bulletin
  116. boards and other sources which employ the "QWK" format for mail
  117. packets.
  118.  
  119. You may use PMQWK to:
  120.  
  121.   Unpack new QWK mail packets which have been downloaded from a
  122.   bulletin board or other service into a format which is readable
  123.   by PMQWK.  QWK packets from any arbitrary number of bulletin
  124.   boards or services may be examined simultaneously.
  125.  
  126.   Read your unpacked messages.  Each bulletin board or service may
  127.   transmit any number of messages, grouped into 'conferences', and
  128.   all are handled via a tree-like mechanism within PMQWK. Any number
  129.   of conferences for any number of bulletin boards may be opened
  130.   simultaneously within PMQWK.
  131.  
  132.   Reply to any message or enter new messages into a conference and
  133.   prepare them for retransmission to the bulletin board or service.
  134.   PMQWK handles such things as quoting the original message,
  135.   attributing quotes, maintaining reply links and other bookkeeping
  136.   details while you use the editor of your choice to edit the replies
  137.   or messages.
  138.  
  139.   Entire messages or portions of messages may be saved to alternate
  140.   files either directly or via the system clipboard or may be
  141.   integrated via the clipboard into other documents or files.
  142.  
  143.   Pack replies and messages into a format suitable for
  144.   retransmission to the bulletin board or service.
  145.  
  146.   PMQWK currently supports the following compression programs for
  147.   purposes of packing and unpacking mail packets: PKZIP2 (and PKUNZIP2),
  148.   LH2 (LHArc for OS/2) and ARC2 (SEA ARC for OS/2).  More will be
  149.   added in the near future.
  150.  
  151.  
  152. PMQWK will NOT do the following:
  153.  
  154.   Upload or download QWK mail packets to and from the bulletin boards
  155.   and/or on-line services.  A separate telecommunications program is
  156.   required for this purpose.  We recommend Oberon Software's Terminal
  157.   Emulator/2 (TE/2) as a good, general purpose, terminal program for
  158.   use with PMQWK and with OS/2 in general.
  159.  
  160.   Pack or unpack QWK mail packets without the presence of at least
  161.   one archiving program on your system.  Archiving schemes are, in
  162.   some cases, proprietary to the vendor of the archiving software and,
  163.   in almost all cases, subject to change at the vendors discretion.
  164.   For this reason, PMQWK relies on the presence of one or more of the
  165.   following programs on your system: PKZIP (and PKUNZIP) from PKWare,
  166.   LH2 (LHArc for OS/2), or ARC2 from System Enhancement Associates.
  167.   (PLEASE NOTE: the INFOZIP utilities for zipping and unzipping files
  168.   do NOT work correctly with PMQWK as they lack a key command line
  169.   feature which PMQWK requires.  Oberon Software has developed a
  170.   small utility which will be of assistance in working with these
  171.   programs however.  Beginning with PMQWK Beta #7 ZFRONT.EXE is
  172.   packaged with PMQWK; refer to the file ZFRONT.DOC for further
  173.   information regarding using ZFRONT.)
  174.  
  175.   PMQWK does not include a built-in message editor.  Most everyone
  176.   has his or her favorite text editor and, at the very least, all
  177.   installations of OS/2 should have E.EXE. PMQWK will use E.EXE by
  178.   default but you may specify the editor of your choice and it will
  179.   be automatically invoked for you.
  180.  
  181.  
  182. Features and Functions absent in this BETA TEST Version:
  183.  
  184.   *******************************************************************
  185.   This version of PMQWK is tested on OS/2 2.0 "GA" and OS/2 2.0
  186.   with the Service Pack (XR6055) installed only.  We have experienced
  187.   problems running this version of PMQWK under the OS/2 2.1 BETA
  188.   release dated 12/9/92 and do NOT recommend using it in this
  189.   environment until we have determined the cause of these problems.
  190.   *******************************************************************
  191.  
  192.   Paths are not checked for validity in the "Paths" dialog nor are
  193.   the specified archive programs checked for validity at this point.
  194.   The paths and programs ARE checked for existence and/or validity
  195.   before an attempt is made to use any of these however.  This feature
  196.   will be enabled before General Release.
  197.  
  198.   Memory allocation checking is not complete in this version of
  199.   PMQWK.  It is possible to "run out of memory" by opening too many
  200.   conferences and cause PMQWK to abend with a protection violation.
  201.   Define "too many conferences" in the vicinity of ten or more.  This
  202.   feature will be made bulletproof before General Release.
  203.  
  204.   The Color Settings dialog is not fully functional in this release;
  205.   it is not possible to change the color of highlighted text in
  206.   message displays although the setting for it appears in the dialog.
  207.   This feature may or may not be enabled before General Release.
  208.  
  209.   The settings for PMQWK allow you to specify paths for ZOO and UNARJ
  210.   as packer/unpackers but neither of these programs are supported for
  211.   actual use by this release of PMQWK.
  212.  
  213.   An automated setup procedure will be added before General Release.
  214.  
  215.   The current method of setting personalized icons for BBSes and
  216.   conferences is completely manual and infers a certain amount of
  217.   skill with the file system on the part of the user.  This procedure
  218.   will be automated and simplified.
  219.  
  220.   PMQWK will not always sense when an archiving program has problems
  221.   packing or unpacking a file.  If a new packet is mysteriously
  222.   creating problems, try unpacking the QWK packet by hand to see if
  223.   it might be a damaged file.  Error checking here will be made
  224.   more robust before General Release.
  225.  
  226.   Because this is a BETA TEST release, we expect that you may
  227.   encounter other program omissions or errors.  Please alert Oberon
  228.   Software to these problems as you encounter them.
  229.  
  230.   ┌────────────────────────────────────────────────────────────────┐
  231.   │ For bug reports and enhancements requests:                     │
  232.   │                                                                │
  233.   │   Oberon BBS or OS/2 Shareware BBS to Kimberly Bobrow          │
  234.   │   Fidonet to Kimberly Bobrow at either 1:141/261 or 1:292/60   │
  235.   │   Internet to Kimberly.Bobrow@hnews.fidonet.org                │
  236.   │   Voice phone: 212-465-3367                                    │
  237.   └────────────────────────────────────────────────────────────────┘
  238.  
  239.  
  240. Other important notes and considerations:
  241.  
  242.   As mentioned above, the INFOZIP packing and unpacking utilities
  243.   require use of the included program ZFRONT.EXE for use with PMQWK.
  244.   See ZFRONT.DOC for details.
  245.  
  246.   Certain editors will cause problems with PMQWK.  The OS/2 Enhanced
  247.   Editor (EPM.EXE) will work correctly with PMQWK if and only if
  248.   there are no other copies of EPM running on your machine at the
  249.   time you begin an edit session via PMQWK (this includes other PMQWK
  250.   edit sessions).  The IBM IUO editor, LXPM, does not function
  251.   correctly for use with PMQWK.
  252.  
  253.   If you have used an earlier (16-bit) beta version of PMQWK, you MUST
  254.   delete your PMQWK.INI file before running this version and then use
  255.   the current version to reset your options.
  256.  
  257.  
  258. II.  Installation
  259.  
  260.   A. Files
  261.  
  262.   For best results, a dedicated directory should be made for PMQWK.
  263.   We suggest that you make a directory, on the disk of your choice,
  264.   by the name PMQWK and copy PMQWK.EXE and TagLines.txt into that
  265.   directory.  You should ensure that this directory is your current
  266.   working directory while you are running PMQWK as PMQWK will maintain
  267.   subdirectories for each bulletin board underneath this directory.
  268.  
  269.   Copy the file REGEXPUT.DLL into a directory named in the LIBPATH
  270.   statement from your CONFIG.SYS.
  271.  
  272.   Install PMQWK into PM or WPS as you deem fit.  As mentioned above,
  273.   you should ensure that the directory containing PMQWK.EXE is the
  274.   designated "Working Directory" for executing PMQWK however.
  275.  
  276.   B. First time startup
  277.  
  278.     1. Paths and Options
  279.  
  280.   You may start PMQWK from the OS/2 command line by first ensuring
  281.   that the disk and directory containing PMQWK are current and typing
  282.   "PMQWK" at the system prompt.  If you have installed PMQWK into
  283.   your desktop setup (following the rules for current directory) you
  284.   may start it that way.
  285.  
  286.   Example batch file for starting PMQWK assuming that it is installed
  287.   in to directory 'D:\PMQWK':
  288.  
  289.     @echo off
  290.     D:
  291.     CD \PMQWK
  292.     START /PM /N PMQWK
  293.  
  294.   Example of the first page of the 'Settings' Notebook for a PMQWK
  295.   installation assuming that it is installed into directory
  296.   'D:\PMQWK':
  297.  
  298.    ┌──┬──────────────────────────────────────────────────────┬──┬──┐
  299.    │  │ PMQWK Offline Mail Reader - Settings                 │  │  │
  300.    ├──┴──────────────────────────────────────────────────────┴──┴──┤
  301.    │┌────────────────────────────────────────────────┐             │
  302.    ││                                                │┐            │
  303.    ││                                                ││┐           │
  304.    ││                                                │Program      │
  305.    ││                                                ││││          │
  306.    ││                                                ││Session     │
  307.    ││ Required                                       ││││          │
  308.    ││   Path and file name:                          │││Assocation │
  309.    ││   ┌───────────────────────┐   ┌───────┐        ││││          │
  310.    ││   │D:\PMQWK\PMQWK.EXE     │   │Find...│        ││││General   │
  311.    ││   └───────────────────────┘   └───────┘        ││││          │
  312.    ││                                                ││││          │
  313.    ││ Optional                                       ││││          │
  314.    ││   Parameters:                                  ││││          │
  315.    ││   ┌───────────────────────────────────┐        ││││          │
  316.    ││   │                                   │        ││││          │
  317.    ││   └───────────────────────────────────┘        ││││          │
  318.    ││   Working directory:                           ││││          │
  319.    ││   ┌───────────────────────────────────┐        ││││          │
  320.    ││   │D:\PMQWK                           │        ││││          │
  321.    ││   └───────────────────────────────────┘        ││││          │
  322.    ││                                                ││││          │
  323.    ││ ┌───────┐   ┌───────┐                          ││││          │
  324.    ││ │ Undo  │   │ Help  │                          ││││          │
  325.    ││ └───────┘   └───────┘                          ││││          │
  326.    ││                                             < >││││          │
  327.    │└────────────────────────────────────────────────┘│││          │
  328.    │ └────────────────────────────────────────────────┘││          │
  329.    │  └────────────────────────────────────────────────┘│          │
  330.    │   └────────────────────────────────────────────────┘          │
  331.    │                                                               │
  332.    │                                                               │
  333.    └───────────────────────────────────────────────────────────────┘
  334.  
  335.  
  336.  
  337.   Immediately upon entering PMQWK for the first time, select the menu
  338.   item labeled "Options" and the submenu item labeled "Paths".  Set
  339.   the following items:
  340.  
  341.     Inbound QWK Packets: set this item to the name of the directory
  342.     in which new QWK packets will appear after they have been
  343.     downloaded from the BBS or on-line services.  In general, this
  344.     will be the download directory which your telecommunications
  345.     program uses although you may wish to create a new directory
  346.     specifically for this purpose and move QWK packets into this
  347.     directory by other means after they have been downloaded. [NOTE:
  348.     in this version of PMQWK the validity of this path is NOT checked
  349.     at this point.]
  350.  
  351.     Outbound Reply Packets: set this item to the name of the
  352.     directory where you wish PMQWK to deposit packaged reply packets
  353.     to be uploaded back to the BBS or on-line service.  In general,
  354.     this will be a directory in which your telecommunications
  355.     program expects to find files for upload.  [NOTE: in this version
  356.     of PMQWK the validity of this path is NOT checked at this point.]
  357.  
  358.  
  359.     Packers and Unpackers: fill in as many of these as are applicable
  360.     with the drive, path, and name of the appropriate archiving
  361.     program or programs.  If they exist in a directory referred to in
  362.     your PATH environment variable, you may omit the drive and path
  363.     specification and give only the name of the program file.  [NOTE:
  364.     in this version of PMQWK, these programs names and paths are NOT
  365.     checked for validity at this point. FURTHER NOTE: in this version
  366.     of PMQWK, only the first three archivers are supported:
  367.     PK(UN)ZIP, ARC, and LH.  Entries exist for ARJ and ZOO for future
  368.     use only, they are not used by this version of PMQWK.]
  369.  
  370.  
  371.   [General note for beta release version: the previous three items
  372.   have disclaimers stating that validity on these items are not
  373.   checked during this dialog.  The validity IS checked later at
  374.   appropriate points.  If your "InBound" path is invalid or if you
  375.   have specified no valid archiver programs, PMQWK will find nothing
  376.   suitable for unpacking when that option is selected.  If your
  377.   "OutBound" path is invalid, PMQWK will default to the current
  378.   directory for this function after alerting you to the problem.  If
  379.   no valid archivers have been specified by the time you select the
  380.   option to package reply packets, PMQWK will alert you to the
  381.   problem.]
  382.  
  383.   [Further note: As mentioned above, the INFOZIP utilities for
  384.   zipping and unzipping files are not supported in this release of
  385.   PMQWK.]
  386.  
  387.   After setting the paths, you may investigate the other items on the
  388.   "Options" menu for setting your favorite editor as default, setting
  389.   colors and fonts, and other options or you may leave these settings
  390.   for later.
  391.  
  392.   After setting at least your "Paths", select "Save Options" from the
  393.   "Options" menu and your setup will be saved. [Technical note:
  394.   options are not saved in the system files; a file named PMQWK.INI
  395.   will be made in the same directory as PMQWK.EXE.]  If you attempt
  396.   to exit PMQWK before you have saved your options, PMQWK will query
  397.   you for this.
  398.  
  399.  
  400.     2. Your first QWK packets
  401.  
  402.   If you do not have any QWK packets available, you must first access
  403.   a bulletin board or on-line service and obtain at least one QWK mail
  404.   packet.
  405.  
  406.   Make sure that all QWK mail packet in which you are interested are
  407.   in the directory which you specified as your "InBound" path above.
  408.  
  409.   If you have exited PMQWK, restart the program now.
  410.  
  411.   Select "Unpack QWK Packet" from the menu.  A dialog will appear
  412.   listing the valid QWK packets which were found in your "InBound"
  413.   directory.  Select the packet in which you are interested and press
  414.   the OK button.  The QWK packet will be unpacked and the name of the
  415.   BBS should appear now in the "BBS List" window.  Repeat this
  416.   procedure for all packets which you wish to unpack.
  417.  
  418.   [Note: the first time you start PMQWK with a valid "InBound" path,
  419.   or the first time you select "Unpack QWK Packet" with a valid
  420.   "InBound" path, there may be some delay as PMQWK scans the inbound
  421.   directory for the first time.  This delay will only be significant
  422.   if there are many files matching the pattern "*.qw*" in that
  423.   directory.  Only "new files" are scanned so the delay should not
  424.   be significant on subsequent invocations.]
  425.  
  426.  
  427. III. Using PMQWK
  428.  
  429.   A. Unpacking QWK packets
  430.  
  431.   Make sure that any and all QWK packets in which you are interested
  432.   are located in the directory which you specified as your "InBound"
  433.   path (see section II.B.1 above).  Select "Unpack QWK Packet" from
  434.   the menu or press the "Unpack" button in the "BBS List" dialog
  435.   window.  You will be presented with a list of valid QWK packets
  436.   which PMQWK was able to locate in your "InBound" directory.  Select
  437.   one to unpack either by double clicking on the file name and info
  438.   or by selecting it and pressing the "OK" button.  The packet will
  439.   now be unpacked (if you are about to overwrite another packet,
  440.   you will be given to opportunity to abort the action).  Repeat this
  441.   procedure for every QWK packet you wish to unpack.
  442.  
  443.   If you have never unpacked a packet from this source before, a new
  444.   item will appear in the "BBS List" window at this point.
  445.  
  446.  
  447.   B. Reading messages
  448.  
  449.   To begin the process of reading messages, first select a BBS from
  450.   the "BBS List" window (if this list is empty, you must first unpack
  451.   at least one QWK packet! See "Unpacking QWK packets" above).  After
  452.   selecting a BBS, another dialog will appear which will list the
  453.   available conferences for that BBS.  Conferences which contain
  454.   messages will be indicated with a '+' sign in this list while empty
  455.   conferences will have a '-' as the first character.  Each
  456.   conference also has an indication, in parentheses, of how many
  457.   message are available and your "current position" in the list.  For
  458.   example:
  459.  
  460.                 +4/Netmail (5/15)
  461.  
  462.   indicates that area #4, called "Netmail" has messages, that it has
  463.   fifteen messages and that you will enter viewing the fifth message.
  464.  
  465.   Please note that, by default, areas which contain no messages (and
  466.   would thus have a '-' as the first character in their listing, are
  467.   not shown at all.  To enable their visibility, use the
  468.   "Preferences" dialog and toggle the checkbox labeled "Show only
  469.   active conferences" to OFF.
  470.  
  471.   When you select a conference to view, you will be presented with a
  472.   window which contains a "message header" at the top of the window,
  473.   a scrollable region in the central area containing the message
  474.   text, and a set of buttons at the bottom of the window for
  475.   initiating various activities.
  476.  
  477.   The "message header" contains the following information: the
  478.   message number, the number of the message it refers to (if any),
  479.   the position in the list of messages (in our example above, it
  480.   would read "#5 of 15"), the sender's name, the addressee's name, the
  481.   subject of the message, its time and date stamp, whether it is
  482.   a private or public message, and whether the bulletin board has
  483.   marked this message as "Seen by you" or not.  If this is a net
  484.   mail message, the sender's net address will be given after his/her
  485.   name in parentheses.
  486.  
  487.   Most of the activities are self-explanatory: "Next" and "Prev" will
  488.   view the next and previous message in the conference respectively,
  489.   "Quit" closes the window, "Help" invokes the help display (NOTE:
  490.   "Help" is NOT active in this BETA release!).  "Reply" and "Enter"
  491.   will invoke the reply editor (see "Replying to messages" below) the
  492.   difference being that "Reply" will preset much of the reply header
  493.   information with data from the current message while "Enter" will
  494.   begin the creation of a new, unrelated (as least as far as the QWK
  495.   format is concerned) message.  The other two functions deserve a
  496.   little more information which follows immediately.
  497.  
  498.  
  499.     1. The "List" function
  500.  
  501.   This invokes a dialog window which, initially contains a list of
  502.   all messages in the area, their message number, subject, sender,
  503.   receiver, and time/date.  Messages addressed to you are marked with
  504.   an asterisk "*".  You may select a message from this list and press
  505.   the "OK" button to go immediately to that message.
  506.  
  507.   The "Filter" button in this dialog allows you to view a subset of
  508.   the messages in the list.  You may search for text in "envelope"
  509.   fields (Sender, Receiver, and Subject) or in the message body
  510.   itself.
  511.  
  512.   The filtering is for purposes of the "List" dialog only, it does
  513.   not affect the behavior of the message window at all (except as
  514.   regards jumping to a message).
  515.  
  516.  
  517.     2. The "Copy" function
  518.  
  519.   You may mark areas within the message text using the mouse pointer
  520.   and copy them to the system clipboard using CONTROL+INSERT or you may
  521.   use the "Copy" dialog.  This dialog allows you to refine how you
  522.   export the data to a greater degree.  You may chose to copy the
  523.   entire message or just the marked area (if any), you may optionally
  524.   include header information about the message in the export, and you
  525.   may copy it directly to a file or to the system clipboard.
  526.  
  527.  
  528.     3. The "Replies" conference
  529.  
  530.   There is one extra, pseudo-conference which appears at the
  531.   beginning of each BBS's conference list named "Replies".  This is
  532.   where all of your entered messages and replies will be kept until
  533.   they are packed for retransmission to the BBS.  It behaves in most
  534.   ways exactly like a "normal" message window. However, the "Reply" and
  535.   "Enter" functions are replaced with "Edit" and "Delete".  "Edit"
  536.   will allow you to reedit the message, possibly just the "envelope"
  537.   information or the entire message text, while "Delete" will erase
  538.   the currently viewed reply.
  539.  
  540.   If this is a netmail message, the Receiver's net address will
  541.   appear in parentheses after his/her name.
  542.  
  543.  
  544.  
  545.   C. Replying to messages
  546.  
  547.   To reply to a message, simply invoke the "reply" button while you
  548.   are viewing the message in question.  The message will be placed
  549.   into a file in "quoted" form and your editor will be invoked on
  550.   that file.  You may edit any part of this file and/or append to the
  551.   file.  While your editor is in the process of editing the reply, a
  552.   new icon will appear in the main client window. "Active Edit
  553.   Sessions" contains a list of all current invocations of the editor
  554.   and a button which will allow you immediately switch to any of the
  555.   listed editor sessions.
  556.  
  557.   When you finish editing your reply, you will be returned to PMQWK
  558.   and given the opportunity to edit the "Envelope" information.  This
  559.   will already have your name, the receivers name, net address (if
  560.   applicable), the conference for the message, and the subject filled
  561.   in.  You may edit any of these items except your own name.  If
  562.   "TagLines" are enabled (see "Options") you may select a tagline to
  563.   use from this dialog.
  564.  
  565.   If you press "OK" and all of the required fields are filled in, the
  566.   reply will be saved.  If you press "Cancel" the message will be
  567.   discarded after you confirm that this is your desire.
  568.  
  569.   Should you need to reedit a reply message or delete a reply message,
  570.   invoke the "Replies" pseudo-confernce and perform the desired
  571.   action from there (see "The "Replies" Conference" above).
  572.  
  573.  
  574.     1. The editor
  575.  
  576.   By default PMQWK will invoke E.EXE, the OS/2 system editor to edit
  577.   your replies and other outgoing messages.  If you have an editor
  578.   which you prefer to use, use the "Editor" dialog from the "Options"
  579.   menu (see "Options" below) to specify your editor of choice.
  580.  
  581.  
  582.       a. Word Wrap
  583.  
  584.   Because messages are reformatted based on your setting for "Wrap
  585.   Column" both when quoting a message before a reply and when
  586.   importing your message from the editor back into PMQWK, you should
  587.   be aware of the algorithm used for message formatting so that you
  588.   can achieve a pleasing result.
  589.  
  590.   The message formatter is paragraph based.  It assumes that a new
  591.   paragraph has started when it encounters either a blank line or
  592.   an indented line.  It will pull the entire paragraph together
  593.   to make a "best fit" within your defined wrap column.  For example,
  594.   assuming you have the (unlikely) wrap setting of 30, the following
  595.   text:
  596.  
  597.                     |---|----|----|----|----|----|
  598.                     Now is the time for all good men to
  599.                     come to the aid
  600.                     of their country.
  601.  
  602.   would be reformatted as:
  603.  
  604.                     |---|----|----|----|----|----|
  605.                     Now is the time for all good
  606.                     men to come to the aid of
  607.                     their country.
  608.  
  609.   While the following:
  610.  
  611.                     |---|----|----|----|----|----|
  612.                     Table data:
  613.                         Column 1       Column 2
  614.                         --------       --------
  615.                         Apples         Oranges
  616.  
  617.   would not be reformatted at all because of the indentation.  If you
  618.   are not aware of the way this behaves, you may end up with
  619.   undesirable results.  For instance, if you entered the following:
  620.  
  621.                     |---|----|----|----|----|----|
  622.                     Hello Joe!
  623.                     Whatcha know?
  624.                     I just got back from Kokomo!
  625.                     Yours truly,
  626.                     Ira
  627.  
  628.   it would end up looking like:
  629.  
  630.                     |---|----|----|----|----|----|
  631.                     Hello Joe! Whatcha know? I
  632.                     just got back from Kokomo!
  633.                     Yours truly, Ira
  634.  
  635.   Use blank lines and indentation to avoid having lines pulled back
  636.   for you when you don't want this to happen.
  637.  
  638.  
  639.     2. Messages which are not replies
  640.  
  641.   Sometimes you may wish to enter a message which is not a reply to
  642.   any existing message.  There are two ways to do this: via the
  643.   "Enter" button while viewing a conference, and via the "Message"
  644.   button from the Conference List dialog.  In both cases, the
  645.   procedure that follows is almost exactly that of creating a reply
  646.   message with the following exceptions:
  647.  
  648.     * The "Envelope" dialog will appear both before AND after you
  649.       edit the message.
  650.  
  651.     * No default information is filled in in the "Envelope" dialog
  652.       the first time; you must specify all fields.
  653.  
  654.   Otherwise, for all intents and purposes, a message of this sort is
  655.   treated exactly like any other reply.
  656.  
  657.  
  658.  
  659.   D. Packaging replies for upload
  660.  
  661.   Select "Pack Replies" from the menu or press the "Pack" button is
  662.   the "BBS List" dialog window.  You will be presented with a
  663.   list of all BBSes which have unpacked reply messages defined. 
  664.   Select one or more from this list and press "OK".
  665.  
  666.   For each selection from the previous list, you will be given a
  667.   dialog wherein you may select the archiver to use for packaging
  668.   this reply packet and, if a file by the target name already exists
  669.   in your "OutBound" directory, the option of overwriting that file
  670.   or appending the new messages to it.
  671.  
  672.   There are possibly two buttons in this dialog labeled "List
  673.   Replies"; one which always appears and another which will only be
  674.   present if there already exists a reply packet in your "OutBound"
  675.   path.  This second button appears inside of a group box labeled
  676.   "Existing Replies" in this case.  The first of these buttons will
  677.   provide a list of "Reply Headers" (the conference number, receiver,
  678.   and subject) for each message in the group of new messages the
  679.   second will do the same for the existing replies.  Note, if the
  680.   existing reply packet was not created using PMQWK, PMQWK will not
  681.   attempt to list its contents.
  682.  
  683.   The button labeled "Change Path" will invoke a dialog wherein you
  684.   may override the currently set "OutBound" path (or reset it to the
  685.   default value if you have changed it).
  686.  
  687.   Press the "OK" button to begin the packing process, press "Cancel"
  688.   to abort the process.
  689.  
  690.  
  691.   E. The Address Book
  692.  
  693.   The address book feature of PMQWK is activated by choosing "Address
  694.   Book" from the "Files" menu in the main client window of PMQWK. 
  695.   This is a small database wherein you may keep an organized list
  696.   of names, netmail addresses, and notes for future reference.
  697.  
  698.   Each data record in the Address Book consists of four fields:
  699.   a 'Search key', and 'Name', and a 'Net Address', each of which may
  700.   be up to 25 characters long plus a 'Notes' field which can hold
  701.   up to 949 characters of information.
  702.  
  703.   The reason for having the 'Key' field separate from the 'Name'
  704.   field is so that you may enter the name as it is to appear in
  705.   your reply envelopes (i.e., Name: "Barney Rubble") and still have
  706.   your list sorted by something other than first name (i.e.,
  707.   Search Key: "Rubble, Barney").
  708.  
  709.   There are five buttons in the Address Book window, each of which
  710.   will initiate an action.  'Close' will close the address book
  711.   window, 'New' will insert a new, empty record and place the
  712.   Address Book in edit mode for that record, 'Edit' will place the
  713.   address book into edit mode for the currently viewed record,
  714.   'Delete' will delete the currently displayed record (NOTE WELL:
  715.   in the BETA release of the program, the user is NOT queried at
  716.   this point whether or not to really delete the record!), and
  717.   'Help' will display help for the Address Book functions (NOTE:
  718.   in this BETA release, the 'Help' button is not active.).
  719.  
  720.   By default, the Address Book comes up in 'lookup mode'.  You may
  721.   view the details for any entry by either selecting its key from
  722.   the listbox at the left of the window or by typing the first
  723.   character or characters of the key into the entry field labeled
  724.   'Search Key' in the upper left of the window.  The latter performs
  725.   an 'incremental search' through the list of keys, that is, if you
  726.   type 'F', the listbox highlight moves to the first entry which
  727.   begins with an 'F' (this is not case sensitive), if you then
  728.   proceed to type an 'L', the highlight moves to the first entry
  729.   in the listbox which begins with 'FL'.
  730.  
  731.   You enter 'edit mode' by pressing either the 'New' button or the
  732.   'Edit' button.  The 'New' button inserts a new, blank record and
  733.   allows you to edit that record; the 'Edit' button is only available
  734.   if a valid record is currently displayed and it allows you to edit
  735.   the currently viewed record.
  736.  
  737.   In 'edit mode', the listbox is replaced with a short, informational
  738.   message and all four of the entry fields (Search key, Name, Net
  739.   Addr, and Notes) will now accept input.  You may type anything into
  740.   these fields you wish; you may use all of the standard OS/2 editing
  741.   keys and clipboard functions (i.e., Shift+Delete, Ctrl+Insert, and
  742.   Shift+Insert for Cut, Copy, and Paste).  To save the record as
  743.   edited, press the "Save" button, to cancel changes press the
  744.   "Cancel" button (NOTE: in this BETA release of the program, the
  745.   "Help" button is not active).  If you have edited the 'Search Key',
  746.   the listbox in the 'view mode' window will be rearranged as needed.
  747.  
  748.   1. Copying information to the Envelope window
  749.  
  750.   As mentioned above, the OS/2 editing keys which allow you to access
  751.   the system clipboard are active, that is, you may 'Mark' the name
  752.   in the Address Book with the mouse or the keyboard, copy it to
  753.   the clipboard (Ctrl+Insert) and paste it into any OS/2 application
  754.   which will accept clipboard data.  This, of course, includes the
  755.   the fields in PMQWK's Envelope windows.  For direct communication
  756.   with the Envelope window, however, you may elect to use the built-in
  757.   "Drag and Drop" interface.
  758.  
  759.   If you press and hold Mouse Button Two (usually the right mouse
  760.   button) while the mouse pointer is over the 'Name" field or field
  761.   label in the Address Book window, the mouse pointer will change
  762.   into a small rectangle with the word "NAME" in it.  Still holding
  763.   mouse button two, move the mouse pointer to the Envelope window
  764.   in which you wish this name to appear until the superimposed circle
  765.   with a slash disappears and release the mouse button.  The name
  766.   will replace whatever text is currently in the "To:" field in the
  767.   envelope window.  If you begin this operation from the "Net Addr"
  768.   field or field label in the Address Book window, the mouse pointer
  769.   will instead read "NET" and the data will be placed into the "Net:"
  770.   field in the envelope window.  If you begin from anywhere else in
  771.   in the Address Book window other than directly over the above
  772.   mentioned fields or their labels, the mouse pointer will appear as
  773.   two rectangles, "NAME" and "NET", and the data will go to both
  774.   fields in the Envelope window.  To cancel the drag and drop
  775.   operation, simply release the mouse button anywhere where it DOES
  776.   have the circle-slash visible.
  777.  
  778.   There is no corresponding drag and drop mechanism for copying data
  779.   from the Envelope into the Address Book in this release of PMQWK.
  780.   You may, of course, use the system clipboard to accomplish this as
  781.   outlined above.
  782.  
  783.  
  784.   F. Options
  785.  
  786.   There are several user settable options which you may specify via
  787.   the various items on the "Options" menu.
  788.  
  789.     1. Fonts
  790.  
  791.   This dialog will allow you to set the fonts which PMQWK will use
  792.   for message displays and list boxes.
  793.  
  794.  
  795.     2. Colors
  796.  
  797.   This dialog will allow you to set the colors which PMQWK will use
  798.   for message displays and list boxes. [NOTE: In this BETA release
  799.   of PMQWK, entries appear for "Message HiLited Text" and "Message
  800.   HiLited Text Background".  These setting are NOT functional in this
  801.   release, the highlighted colors in message displays are a function
  802.   of the normal, non-hilighted colors.]
  803.  
  804.  
  805.     3. Paths
  806.  
  807.   This topic has already been covered elsewhere in this document. 
  808.   Please refer to Section II.B.1 for information on these settings.
  809.  
  810.  
  811.     4. Editor
  812.  
  813.   You may select your editor of choice here for purposes of editing
  814.   reply messages.  Type the name of the editor in the indicated
  815.   field, if the program file is not in a directory referred to in
  816.   your PATH environment variable, you must include the entire drive
  817.   and path specification for the program.  Once you have specified
  818.   a valid program name here you will be given the opportunity to
  819.   select how the program will be executed, i.e., as a Presentation
  820.   Manager program, in a full screen session, or in a windowed
  821.   session.
  822.  
  823.  
  824.     5. Preferences
  825.  
  826.   Preferences is a catchall for a number of semi-related settings.
  827.  
  828.       a. Beep on personal messages
  829.  
  830.   If this setting is checked, PMQWK will alert you with a tone
  831.   whenever you view a message addressed to you.
  832.  
  833.       b. Attribute quotes
  834.  
  835.   If this setting is checked, you specify that you want PMQWK to
  836.   provide an "Attribution" to the quotes in your reply messages and
  837.   you may further specify how you wish this Attribution to appear.
  838.   Type any text you wish into the associated entry field and it will
  839.   be echoed into your reply messages.  There are several special
  840.   character sequences which you may embed into this text which will
  841.   cause PMQWK to insert relevant information from the message header:
  842.  
  843.     %s inserts the SENDER's name from the original message
  844.     %r inserts the RECEIVER's name from the original message
  845.     %j inserts the SUBJECT of the original message
  846.     %d inserts the DATE of the original message
  847.     %t inserts the TIME of the original message
  848.     %_ inserts a line break in the attribution string
  849.     %% is used to insert a '%' character in the string.
  850.  
  851.   Please note, these codes ARE case sensitive!  "%S" will NOT work
  852.   like "%s", instead it will simply insert the characters "%S" into
  853.   the attribution string.
  854.  
  855.  
  856.       c. Wrap Column for Quotes
  857.  
  858.   The column at which lines will be broken for purposes of quoting
  859.   original messages.  PMQWK attempts to be intelligent about word
  860.   boundaries and will try to wrap lines at word breaks.
  861.  
  862.  
  863.       d. Prepend "Re:" to response subject lines
  864.  
  865.   Automatically place the characters "Re: " at the beginning of
  866.   subjects lines in replies.  "Re: " will NOT be prepended if those
  867.   characters are already present at the beginning of the subject.
  868.  
  869.  
  870.       e. Strip existing "Re:" from subject lines
  871.  
  872.   Remove the characters "Re:" and any white space following from
  873.   subject lines in replies.  Note that this option and the previous
  874.   are NOT mutually exclusive!  If they are both checked, subject
  875.   lines in replies will always contain one and only one "Re:", if
  876.   neither is checked, no subject line is ever altered by PMQWK.
  877.   Note further that you have the ability to add or remove any
  878.   characters you wish from a subject line via the "Envelope"
  879.   dialog; these setting are provided as a convenience.
  880.  
  881.  
  882.       f. Prev/Next buttons on right in message reader
  883.  
  884.   You may prefer it if the "Next" and "Prev" buttons appeared on the
  885.   right side of the message reader window and closer to the scroll
  886.   bars which govern the message text.  If so, set this option ON.
  887.   Be warned, however, that if you move the focus in this window
  888.   using the TAB or arrows keys that the focus will appear to move
  889.   out of order with respect to these buttons!
  890.  
  891.  
  892.       g. Use Taglines
  893.  
  894.   If this option is checked, PMQWK will look in the same directory
  895.   that contains the PMQWK.EXE file for a file named "TagLines.txt".
  896.   If it is found it will use this for it's source of tag lines
  897.   (humorous or provocative short quotes which will be appended to
  898.   your outgoing messages) and the "TagLine" drop-down list will
  899.   be enabled in the various "Envelope" dialogs.  From there you
  900.   may select a line from the list, type in a fresh one "on the fly",
  901.   or erase it entirely.
  902.  
  903.   The TagLines.txt file is a flat ASCII file containing one tagline
  904.   per line of file; you may edit this file with any text editor.
  905.   Taglines should not be longer than about 60 or 70 characters.
  906.  
  907.  
  908.       h. Use PMQWK Cutline
  909.  
  910.   If this option is set OFF then PMQWK will not append it's own
  911.   "signature line" to your outgoing messages.
  912.  
  913.  
  914.       i. Show only active conferences
  915.  
  916.   If this option is set ON (the default), PMQWK will only display
  917.   those conference names belonging to conferences containing more
  918.   than zero messages in the "Conference List" dialog.  Use this
  919.   setting if you have a large number of empty conferences listed
  920.   by a BBS and you do not wish to navigate past them to find the
  921.   active areas.
  922.  
  923.  
  924.     6. Save options
  925.  
  926.   All options discussed in this section may be saved
  927.   semi-permanently in an initialization file by selecting this
  928.   option.  You may always change an option again and resave it.
  929.   If you change options and do not select "Save options" before
  930.   you attempt to exit PMQWK, you will be alerted to this fact and
  931.   given the opportunity to do so at that point.
  932.  
  933.   Options are saved in a file named PMQWK.INI in the same directory
  934.   as PMQWK.EXE.  If you've really made a mess of your settings and
  935.   wish to "start from scratch" just delete this file while PMQWK is
  936.   not running and restart the program (see section II.B.1 for first
  937.   time startup directions).
  938.  
  939.     7. Icons
  940.  
  941.   Though not on any menu within this version of PMQWK, you may
  942.   specify your own custom icons and attach them to any "BBS
  943.   Conference List" dialog or to any "Conference" dialog.  You must
  944.   use OS/2 version 1.3 compatible color or black and white icon
  945.   files (.ICO).  To do this, create a directory underneath the
  946.   directory containing PMQWK.EXE named "PMQIcons" and place all of
  947.   your custom icon files in this directory.  PMQWK will determine
  948.   how to use these icons by the names you give the files:
  949.  
  950.     To attach an icon to a BBS (Conference List Dialog) give the
  951.     icon file the same "first name" as the BBS id and an extension
  952.     of .ICO.  (Example: A BBS id might be "FERNWOOD", name the
  953.     icon file "FERNWOOD.ICO").
  954.  
  955.     To attach an icon to a specific conference for a specific BBS,
  956.     use the same first name as above but give the file an extension
  957.     which is the conference number, left padded to three characters
  958.     with zeros (Example: to attach an icon to conference #5 for the
  959.     "FERNWOOD" BBS, name the icon file "FERNWOOD.005").
  960.  
  961.     To attach an icon to the "Personal Messages" conference, do as
  962.     above but give the icon file the extension ".PER".  To attach
  963.     it to the "Replies" pseudo-conference, give it the extension
  964.     ".ANS".
  965.  
  966.   [NOTE: This procedure will be built into the program and made more
  967.   easy for the average user in the future.  Do not attempt this
  968.   procedure if the above discussion made little or no sense to you!]
  969.  
  970.  
  971.  
  972.  
  973. Happy Mail Reading!
  974. Brady Flowers
  975. Kimberly Bobrow
  976. Oberon Software
  977. 19 January, 1993
  978.  
  979.